IRIX Base Documentation 2001 May

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / u_man / cat1 / X11 / showps.z / showps

Wrap

Text File | 2001-04-17 | 64.9 KB | 1,453 lines

SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) NNNNAAAAMMMMEEEE showps - Adobe Systems PostScript language document previewer. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS sssshhhhoooowwwwppppssss [-usage] [-help] [-dis1] [-dis2] [-dis3] [-dis4] [-ept] [-igc] [-maxp _s_i_z_e] [-mono] [-or _o_r_i_e_n_t_a_t_i_o_n] [-pro _f_i_l_e] [-qfb] [-ps _p_a_g_e_s_i_z_e] [-repsf] [-pscan _s_i_z_e] [-sc _s_c_a_l_e] [-sf] [-skipc] [-tdir _d_i_r] [-v] [-visual _v_i_s_u_a_l] [-depth _d_e_p_t_h] [-wp] [-] [_f_i_l_e_s] DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN The Adobe ShowPS program displays PostScript language documents in an X window, using the Display PostScript extension in the X server. The program allows you to preview and page through both structured and unstructured PostScript language documents. You can choose the size, scale, and orientation of the display. OOOOPPPPTTTTIIIIOOOONNNNSSSS You can provide command line options in upper or lower case (the argument to the ----ppppssss option is the only exception). The options may appear in any order, but filenames must come after all other options. Instead of using an option, you can often set an X resource or select a menu command to achieve the same behavior change. In that case: * Use the X resource to permanently set your preferred default (see RESOURCES). * Use the option to override the resource setting for one session. * Use the menu command to temporarily override the resource or option setting (see USER INTERFACE). The Adobe ShowPS program supports all standard X toolkit options described in the X(1) manual page. In addition, the program supports the following options: ----uuuussssaaaaggggeeee ----hhhheeeellllpppp Lists command syntax, command-line options summary, and X resource for each option. The -help and -usage command options are equivalent. ----vvvveeeerrrrssssiiiioooonnnn Displays the version number of the ShowPS product. Page 1 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) ----rrrreeeettttaaaaiiiinnnn (retain colors) If ShowPS allocates colors in the default colormap, those colors, by default, do not remain allocated in the colormap after ShowPS exits. Instead, the entries are freed and made available for other applications that use the default colormap. However, if the -retain option is specified and ShowPS has allocated colors in the default colormap, these colors do remain allocated in the colormap after ShowPS exits. If the visual is not the default visual, or if SHowPS creates a separate colormap, then the allocated colors are not retained, whether or not the -retain option is specified and regardless of the value of colormapRetainColors, the associated X resource. Resource: colormapRetainColors Defaults: False ----sssseeeeppppccccmmmmaaaapppp (separate colormap) If the visual is not the default visual, ShowPS allocates the Display PostScript colorcube and grayramp in a separate colormap whether or not the -sepcmap option is specified and regardless of the value of colormapAllowSeparateMap. If the visual is the default visual, ShowPS first tries to allocate the Display PostScript colorcube and graymap in the default colormap. If the colorcube and grayramp fit in the default colormap, then no further action is taken. However, if there is not enough room, then ShowPS either shrinks the colorcube and grayramp until they fit in the default colormap or allocates a separate colormap, according to the following rules: ShowPS shrinks the colorcube and grayramp if either of the following conditions is true: * The selected visual is read-only (StaticGray, StaticColor, or TrueColor). * The colormapAllowSeparate resource is set to False and -sepcmap option is not specified. If neither of these conditions is true, ShowPS allocates the Display PostScript colorcube and grayramp in a separate colormap. Note that allowing ShowPS to create a separate colormap can cause other applications to be shown in false colors when the window manager's focus in on ShowPS. Resource: colormapAllowSeparateMap Page 2 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) Default: True ----rrrreeeeddddssss _n_u_m_b_e_r Sets the preferred number of red colors in the Display PostScript colorcube. Values of _n_u_m_b_e_r can be integers 0, 2-256. If the _n_u_m_b_e_r is zero, ShowPS uses resources in your .Xdefaults file to determine what value to use. For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r _G_u_i_l_d, installed as /usr/lib/DPS/doc/ShowPSUserGuide.ps, Appendix D, in the section titled "Specifying zero as a color value." Resource: colormapReds Default: 0 ----ggggrrrreeeeeeeennnnssss _n_u_m_b_e_r Sets the preferred number of green colors in the Display PostScript colorcube. Values of _n_u_m_b_e_r can be integers 0, 2-256. If the _n_u_m_b_e_r is zero, ShowPS uses resources in your .Xdefaults file to determine what value to use. For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r _G_u_i_l_d, installed as /usr/lib/DPS/doc/ShowPSUserGuide.ps, Appendix D, in the section titled "Specifying zero as a color value." Resource: colormapGreens Default: 0 ----bbbblllluuuueeeessss _n_u_m_b_e_r Sets the preferred number of blue colors in the Display PostScript colorcube. Values of _n_u_m_b_e_r can be integers 0, 2-256. If the _n_u_m_b_e_r is zero, ShowPS uses resources in your .Xdefaults file to determine what value to use. For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r _G_u_i_l_d, installed as /usr/lib/DPS/doc/ShowPSUserGuide.ps, Appendix D, in the section titled "Specifying zero as a color value." Resource: colormapBlues Default: 0 ----ggggrrrraaaayyyyssss _n_u_m_b_e_r Sets the preferred number of grays in the Display PostScript colorcube. Values of _n_u_m_b_e_r can be integers 0, 2-256. If the _n_u_m_b_e_r is zero, ShowPS uses resources in your .Xdefaults file to determine what value to use. For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r _G_u_i_l_d, Appendix D, in the section titled "Specifying zero as a color value." Resource: colormapGrays Default: 0 ----ddddiiiissss1111 (display option 1) Displays the Shortcut Panel at startup for immediate access. The Shortcut Panel Page 3 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) contains commonly used File, Page, and Controls menu commands. Resource: displayShortcutPanelDialogAtStartup Default: False ----ddddiiiissss2222 (display option 2) Displays the Scale Selection panel at startup. The Scale Selection panel lets you enlarge or reduce the displayed image. Resource: displayScaleSelectionDialogAtStartup Default: False ----ddddiiiissss3333 (display option 3) Displays the Page Selection panel at startup. The Page Selection panel lets you select a page for viewing. Resource: displayPageSelectionDialogAtStartup Default: False ----ddddiiiissss4444 (display option 4) Displays the Page Orientation panel at startup. The Page Orientation panel lets you change the orientation of the page within the window. Resource: displayPageOrientationDialogAtStartup Default: False ----eeeepppptttt (emulate paper trays) Changes the page size when the PostScript language document contains a request for a different paper size. You need this option only if the associated X resource, emulatePaperTrays, has been set to False and you want to change the behavior. Resource: emulatePaperTrays Default: True ----iiiiggggcccc (ignore comments) Ignores all document structuring convention (DSC) comments in a PostScript language file, that is, treats the document as an unstructured document. This can be helpful for viewing an incorrectly structured document. See also filterps(1). Resource: ignoreComments Default: False ----mmmmaaaaxxxxpppp _s_i_z_e When the program displays a page, it first writes the whole page to an offscreen buffer called a pixmap, then copies the buffer content to the window. The ----mmmmaaaaxxxxpppp option sets the maximum number of bytes of memory that the program is allowed to allocate for that buffer. The default value is 4 Mbytes. The _s_i_z_e parameter may be followed by `k` for kilobytes or `m` for megabytes; for example, -maxp 3m. If _s_i_z_e is Page 4 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) zero, the program does not create a pixmap and draws directly to the window. Final window size is based on the page size specification and the scale factor. If either the final window width or the final window height exceeds 8 000 pixels, the program reduces the scale factor. A large page size requires allocation of a substantial amount of memory for the pixmap. If the memory required for the pixmap exceeds the default or the limit set by this option, the program displays a message and draws directly to the window afterward. See EXCEEDING PIXMAP MEMORY below. If you increase the value of the _s_i_z_e parameter beyond the default, the previewer may slow down when you increase the scale factor. This is caused by increased paging in the system when the X server allocates a large pixmap. Resource: maxPixmapBytes Default: 4000000 ----mmmmoooonnnnoooo Displays documents as they would appear on a monochrome printer. This may improve performance of the previewer, since monochrome documents require a much smaller pixmap. You can choose between optimum performance and optimum display quality: * Consider using ----mmmmoooonnnnoooo to enhance performance if you are previewing monochrome documents on a color display. * Don`t use ----mmmmoooonnnnoooo if memory or speed are not an issue; this gets you the highest quality display on all monitors. Resource: monochrome Default: False ----oooorrrr _o_r_i_e_n_t_a_t_i_o_n Sets the page orientation to the specified value. Valid choices are: * portrait - The "normal" upright orientation * landscape - The page rotated 90 degrees clockwise * flip_portrait - The page rotated 180 degrees clockwise * flip_landscape - The page rotated 270 degrees clockwise Resource: pageOrientation Default: portrait ----pppprrrroooo _f_i_l_e Page 5 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) Sets the pathname to an external PostScript prolog file. The previewer sends this file to the Display PostScript context after the internal prolog and before the PostScript file. This option can be used to implement stubs for site- specific ssssttttaaaattttuuuussssddddiiiicccctttt operators, which may be used in PostScript files at certain sites. Resource: prologFile Default: none ----ppppssss _p_a_g_e_s_i_z_e Specifies the size of the drawing area. _p_a_g_e_s_i_z_e can be the name of a standard page size (ledger, b, c0, and so on) or two numbers, separated by a colon, that define the width and height of a custom page. The default page size is 8.5 x 11 inches. Possible values for the pagesize argument include: * a, b, c, d, e, f, or e1 (American ANSI) * a0, a1, ... a10 (metric ISO) * b0, b1, ... b10 (metric ISO) * c0, c1, ... c7 (metric ISO) * width:height (custom size) Width and height are by default specified in inches and may be integers or floating-point numbers. To specify units other than inches, follow the number with: * cm to specify centimeters * mm to specify millimeters * px to specify pixels * pt to specify points Other values for the pagesize argument are supported for convenience. Examples are: legal (8.5 x 14), ledger (11 x 17), and executive (7.25 x 10.50). Case is significant when specifying arguments to the -ps option. In many instances, upper-case arguments designate 90 degree rotated versions of the lower case arguments. For example, lllleeeetttttttteeeerrrr designates a page size of 8.5 x 11 inches, while LLLLeeeetttttttteeeerrrr designates a page size of 11 x 8.5 inches. To view a complete list of all the supported values for the pagesize argument, use the ----hhhheeeellllpppp option, or consult the _A_d_o_b_e _S_h_o_w_P_S _U_s_e_r _G_u_i_d_e. If you choose a page size too small for the current page, the effect is the same as if you used a paper size too small for a document you print. The program displays as much of the document as fits on the page but does not provide scroll bars. To view the whole Page 6 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) page, choose a large enough page size, then scroll or scale the document as needed if it is larger than the window. Resource: pageSize Default: letter ----ppppssssccccaaaannnn _s_i_z_e (pre-scan size) Certain applications prepend sequences of control characters and other text strings to the PostScript files they generate. When the previewer opens such a file, it searches through the first _s_i_z_e characters for the PostScript identifier string ``%!''. If found, the previewer starts rendering the PostScript file starting at the file offset where the identifier was found. If not found, the previewer assumes that the identifier starts at the character immediately following the first _s_i_z_e characters of the file. If the identifier string is missing, the previewer displays a dialog box that asks whether to display the file anyway. The _s_i_z_e parameter may be followed by k for Kbytes and m for Mbytes. If _s_i_z_e is greater than 100 Mbytes, an error message results. If _s_i_z_e is zero, the previewer skips the pre-scan and assumes that the PostScript identifier string starts in the first position in the first line of the file. The default value is 8200, which allows for the common case where the header size is 8192 bytes. Resource: preScanSize Default: 8200 ----rrrreeeeppppssssffff (reposition EPS files) Encapsulated PostScript (EPS) files can contain images at an arbitrary location on the page. By default, the previewer aligns the upper left corner of the image with the upper left corner of the page. If the associated resource (repositionEPSF) has been changed to False, you can use the ----rrrreeeeppppssssffff option to return to the default behavior. Resource: repositionEPSF Default: True ----qqqqffffbbbb (quiet fall back) When set, ShowPS falls back to unstructured mode if it cannot find %%Page comments in the PostScript file being viewed. When not set, a message window appears to alert the user that the file is not structured. Resource: quietFallback Default: True ----sssscccc _s_c_a_l_e Page 7 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) Sets a scale factor which applies to the page size and to the drawing on the page. The scale factor may be an integer or a floating point number. The default value for the scale factor is 1 (one). The legal range is 0.1 through 10.0. Resource: scale Default: 1.0 ----ssssffff (substitute fonts) Substitutes Courier font if a document requires a font that is not available. You need this option only if you have changed the value of the substituteFonts resource to False. In that case, the previewer displays an error message if you try to load a file that requires unavailable fonts and the X server does not provide font substitution. A message explains why the previewer cannot load the file. Resource: substituteFonts Default: True ----sssskkkkiiiippppcccc (skip copyright) Skips the copyright notice that is usually displayed when you start the program. Resource: skipCopyright Default: True ----ttttddddiiiirrrr _d_i_r When the program reads from _s_t_d_i_n, it temporarily stores the input from _s_t_d_i_n in the directory specified by the _t_e_m_p_D_i_r resource (_t_m_p by default) and later removes it. Use this option to specify a different directory for storing the input. Resource: tempDir Default: /tmp ----vvvv (verbose) Prints a short message to _s_t_d_e_r_r each time an error dialog box is displayed. This allows you to save error messages to a file for later inspection and debugging. Resource: verbose Default: False ----wwwwpppp (watch progress) By default, the program writes a page to a pixmap and displays it only when it is complete. When you use the ----wwwwpppp option, the program displays parts of the page as it is being drawn. While the option lets you observe the progress of a display that requires lengthy preparation, the order in which chunks are displayed is not meaningful. Resource: watchProgress Default: False ---- If you supply "-" instead of a filename, the program Page 8 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) reads from _s_t_d_i_n. In that case, the program temporarily stores the input from _s_t_d_i_n in the directory specified by the _t_e_m_p_D_i_r resource and later removes it. The "-" option makes it possible to view plain text files. Run the file through a program that generates PostScript language output and pipe the output to the previewer's _s_t_d_i_n. _f_i_l_e_s Loads one or more files into the previewer at startup time. DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTT RRRREEEEQQQQUUUUIIIIRRRREEEEMMMMEEEENNNNTTTTSSSS If a document uses the PostScript language incorrectly, the program may not be able to display it. A file type should be indicated on the first line of the document, even if it is a hand-coded PostScript language file. An unstructured document is indicated by a percent sign directly followed by an exclamation point (%!). If the ``%!'' characters are not found on the first line of the file, the previewer will open a dialog window in which you can specify the file as an unstructured PostScript document. SSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEEDDDD AAAANNNNDDDD UUUUNNNNSSSSTTTTRRRRUUUUCCCCTTTTUUUURRRREEEEDDDD DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTSSSS The ShowPS program does not require a structured PostScript language document, as defined in Appendix G of the _P_o_s_t_S_c_r_i_p_t _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, _S_e_c_o_n_d _E_d_i_t_i_o_n. When you view an unstructured document you cannot go directly to a page, but you can page forward through the document and return to the first page. The program displays a trailing blank page at the end of each unstructured document. If a document uses DSC comments incorrectly, the program may not be able to display it or may display it as an unstructured document. You can use the ffffiiiilllltttteeeerrrrppppssss utility to convert some documents to correctly structured documents. SSSSPPPPEEEECCCCIIIIAAAALLLL DDDDOOOOCCCCUUUUMMMMEEEENNNNTTTTSSSS The program detects structured documents whose pages have been placed in reverse order and displays the pages in normal order. When you view a standalone Encapsulated PostScript (EPS) file the program displays the file with its top left corner in the top left corner of the window. This reduces unnecessary scrolling. You can use the _r_e_p_o_s_i_t_i_o_n_E_P_S_F resource, the rrrreeeeppppssssffff option, or the RRRReeeeppppoooossssiiiittttiiiioooonnnn EEEEPPPPSSSS FFFFiiiilllleeeessss command in the OOOOppppttttiiiioooonnnnssss menu to change this behavior. Page 9 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) EEEEXXXXCCCCEEEEEEEEDDDDIIIINNNNGGGG PPPPIIIIXXXXMMMMAAAAPPPP MMMMEEEEMMMMOOOORRRRYYYY When the Adobe ShowPS program displays a page, it first draws the whole page to a pixmap. By default, the program allocates 4 Mbytes of memory for the pixmap. The exact number depends on the machine on which you have the display. You can change the upper limit with the ----mmmmaaaaxxxxpppp option. A large page size, whether requested by the ----ppppssss option or by a command in the PostScript language document, requires allocation of a substantial amount of memory. For example, on a machine that displays 100 dots per linear inch, each square inch has 10 000 dots. If the machine is an 8-bit color machine, 10 kilobytes are needed for each square inch of the page. If the combination of the requested page size and scale factor require pixmap memory that exceeds the upper limit, the program does not allocate a pixmap but draws directly to the window instead. In that case, the program displays a warning message. Whether this message is displayed again depends on the action you take: * If you reduce the scale factor but the required pixmap storage still exceeds the number specified by the ----mmmmaaaaxxxxpppp option, the message is displayed again. This helps you determine how far the scale factor has to be reduced. * If you increase the scale factor, the message is not redisplayed, since you already know there is not enough space. This prevents the message from popping up repeatedly as you move the scale slider. * If you don't reduce the scale factor and open another file, that file won't have a pixmap either. Since you have been informed already, no message is displayed. After you have acknowledged the message, structured documents are drawn directly to the window. If you are viewing an unstructured document, the previewer can display only the part of the page that was in the viewing area and not covered by other panels. You have two options: (1) Decrease the scale factor until the previewer can allocate a pixmap again, using the error messages as a guide. (2) Scroll the page to view the area you want to examine, then choose RRRReeeeooooppppeeeennnn from the FFFFiiiilllleeee menu and page forward to the information you want to see. KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS PPPPaaaaggggeeee 11110000 ((((pppprrrriiiinnnntttteeeedddd 4444////33330000////99998888)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) FFFFiiiilllleeee MMMMeeeennnnuuuu Previous Crtl+V Next Crtl+N Open... Crtl+O Reopen Crtl+R Print... Crtl+P Exit Crtl+Q PPPPaaaaggggeeee MMMMeeeennnnuuuu Previous Page Crtl+B, b, p, PageUp Next Page Crtl+F, f, n, Return, spacebar, PageDown Last Page Viewed Crtl+L Redraw Page Crtl+D Page Selection... Crtl+P Notes: Press 'Home' to display first page and 'End' to display last page. BBBBooooooookkkkmmmmaaaarrrrkkkkssss MMMMeeeennnnuuuu Previous Bookmark Crtl+E Next Bookmark Crtl+X Bookmark Info... Crtl+I Mark/Unmark Page Crtl+K, m VVVViiiieeeewwww MMMMeeeennnnuuuu Shortcut Panel... Crtl+C Scale Selection... Crtl+S Page Orientation... Crtl+T PPPPAAAAGGGGEEEE SSSSIIIIZZZZEEEESSSS Page size options include page sizes defined by the user and the following international standard page sizes: MMMMeeeettttrrrriiiicccc IIIISSSSOOOO AAAA ssssiiiizzzzeeeessss:::: a0 841.0 x 1189.0 mm (33.11 x 46.81 in) a1 594.0 x 841.0 mm (23.39 x 33.11 in) a2 420.0 x 594.0 mm (16.54 x 23.39 in) a3 297.0 x 420.0 mm (11.69 x 16.54 in) a4 210.0 x 297.0 mm ( 8.27 x 11.69 in) a5 148.0 x 210.0 mm ( 5.83 x 8.27 in) a6 105.0 x 148.0 mm ( 4.13 x 5.83 in) a7 74.0 x 105.0 mm ( 2.91 x 4.13 in) a8 52.0 x 74.0 mm ( 2.05 x 2.91 in) a9 37.0 x 52.0 mm ( 1.46 x 2.05 in) a10 26.0 x 37.0 mm ( 1.02 x 1.46 in) MMMMeeeettttrrrriiiicccc IIIISSSSOOOO BBBB ssssiiiizzzzeeeessss:::: b0 1000.0 x 1414.0 mm (39.37 x 55.67 in) b1 707.0 x 1000.0 mm (27.83 x 39.37 in) b2 500.0 x 707.0 mm (19.68 x 27.83 in) b3 353.0 x 500.0 mm (13.90 x 19.68 in) b4 250.0 x 353.0 mm ( 9.84 x 13.90 in) b5 176.0 x 250.0 mm ( 6.93 x 9.84 in) b6 125.0 x 176.0 mm ( 4.92 x 6.93 in) Page 11 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) b7 88.0 x 125.0 mm ( 3.46 x 4.92 in) b8 62.0 x 88.0 mm ( 2.44 x 3.46 in) b9 44.0 x 62.0 mm ( 1.73 x 2.44 in) b10 31.0 x 44.0 mm ( 1.22 x 1.73 in) MMMMeeeettttrrrriiiicccc IIIISSSSOOOO CCCC ssssiiiizzzzeeeessss:::: c0 914.4 x 1300.5 mm (36.00 x 51.20 in) c1 650.2 x 914.4 mm (25.60 x 36.00 in) c2 457.2 x 650.2 mm (18.00 x 25.60 in) c3 325.1 x 457.2 mm (12.80 x 18.00 in) c4 228.6 x 325.1 mm ( 9.00 x 12.80 in) c5 162.6 x 228.6 mm ( 6.40 x 9.00 in) c6 114.3 x 162.6 mm ( 4.50 x 6.40 in) c7 81.3 x 114.3 mm ( 3.20 x 4.50 in) AAAAmmmmeeeerrrriiiiccccaaaannnn AAAANNNNSSSSIIII ssssiiiizzzzeeeessss:::: a 8.5 x 11.0 in ( 215.9 x 279.4 mm) b 11.0 x 17.0 in ( 279.4 x 431.8 mm) c 17.0 x 22.0 in ( 431.8 x 558.8 mm) d 22.0 x 34.0 in ( 558.8 x 863.6 mm) e 34.0 x 44.0 in ( 863.6 x 1117.6 mm) f 28.0 x 40.0 in ( 711.2 x 1016.0 mm) e1 44.0 x 68.0 in (1117.6 x 1727.2 mm) EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS To load two files into the previewer, the first a document in the current directory, the second from /_u_s_r/_l_o_c_a_l/_d_o_c_s: %%%% sssshhhhoooowwwwppppssss mmmmyyyyddddoooocccc....ppppssss ////uuuussssrrrr////llllooooccccaaaallll////ddddooooccccssss////mmmmaaaannnnuuuuaaaallll....ppppssss To view the plain text file _s_t_o_r_y._t_x_t, run the file through a program that generates PostScript language output and pipe the output to the previewer's _s_t_d_i_n. The following example uses the eeeennnnssssccccrrrriiiipppptttt program from Adobe Systems Incorporated. %%%% eeeennnnssssccccrrrriiiipppptttt ----pppp ---- ssssttttoooorrrryyyy....ttttxxxxtttt |||| sssshhhhoooowwwwppppssss ---- To load a file at double scale: %%%% sssshhhhoooowwwwppppssss ----sssscccc 2222 _f_i_l_e_n_a_m_e To start the program for viewing a4 documents: %%%% sssshhhhoooowwwwppppssss ----ppppssss aaaa4444 To start the program for viewing documents 30 cm high by 20 cm wide: %%%% sssshhhhoooowwwwppppssss ----ppppssss 22220000ccccmmmm::::33330000ccccmmmm To set a maximum pixmap size of 5 Mbytes: Page 12 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) %%%% sssshhhhoooowwwwppppssss ----mmmmaaaaxxxxpppp 5555mmmm FFFFIIIILLLLEEEESSSS The name of the application defaults file for the Adobe ShowPS program is _S_h_o_w_p_s. This file should be changed by the system administrator only. Many of the widgets used by the program get their resources from this file. The file must be in one of the directories specified by the XFILESEARCHPATH environment variable. If your site requires the use of a custom prolog file, the system administrator should set the value of the prologFile resource in the _S_h_o_w_p_s file. There are 3 PostScript documents that further explain ShowPS: _S_h_o_w_P_S _U_s_e_r _G_u_i_l_d : /usr/lib/DPS/doc/ShowPSUserGuide.ps _S_h_o_w_P_S _R_e_f_e_r_e_n_c_e _C_a_r_d : /usr/lib/DPS/doc/ShowPSReferenceCard.ps _S_h_o_w_P_S _B_r_o_c_h_u_r_e : /usr/lib/DPS/doc/ShowPS_Brochure.ps To override any of the resources, set them in your ._X_d_e_f_a_u_l_t_s file. RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS The program understands standard Motif resource names and classes. In addition, the following resources allow application-specific customization. _c_o_l_o_r_m_a_p_R_e_t_a_i_n_C_o_l_o_r_s Type: boolean; Default: False Option: ----rrrreeeettttaaaaiiiinnnn Description: If ShowPS allocates colors in the default colormap, those colors, by default, do not remain allocated in the colormap after ShowPS exits. Instead, the colormap entries are freed and made available for other applications that use the default colormap. However, if the colormapRetainColors resource is set to True and ShowPS has allocated colors in the default colormap, those colors remain allocated in the colormap after ShowPS exits. If the visual is not the default visual, or if ShowPS creates a separate colormap, then the allocated colors are not retained, regardless of the value of the resource or the specification of the associated command-line option, ----rrrreeeettttaaaaiiiinnnn. _c_o_l_o_r_m_a_p_A_l_l_o_w_S_e_p_a_r_a_t_e_M_a_p Type: boolean; Default: False Option: ----sssseeeeppppccccmmmmaaaapppp Description: If the visual is not the default visual, ShowPS allocates the Display PostScript colorcube and grayramp in a separate colormap whether or not Page 13 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) the -sepcmap option is specified and regardless of the value of this resource. If the visual is the default visual, ShowPS first tries to allocate the Display PostScript colorcube and grayramp in the default colormap. If the colorcube and grayramp fit in the default colormap, then no further action is taken. However, if there is not enough room, then ShowPS either shrinks the colorcube and grayramp until they fit in the default colormap or allocates a separate colormap, according to the following rules: ShowPS shrinks the colorcube and grayramp if either of the following conditions is true: * The selected visual is read-only (StaticGray, StaticColor, or TrueColor). * The colormapAllowSeparateMap resource is set to False and the -sepcmap option is not specified. If neither of these conditions is true, ShowPS allocates the Display PostScript colorcube and grayramp in a separate colormap. Note that allowing ShowPS to create a separate colormap can cause other applications to be shown in false colors when the window manager's focus is on ShowPS. _c_o_l_o_r_m_a_p_R_e_d_s Type: integer; Default: 0 Option: ----rrrreeeeddddssss _n_u_m_b_e_r Description: Sets the preferred number of red colors in the Display PostScript colorcube. Values for the argument can be integers 0, 2-256. If the value for this resource is zero, ShowPS uses resources in your .Xdefaults file to determine what value to use. For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r _G_u_i_d_e, Appendix D, in the section titled "Specifying zero as a color value." _c_o_l_o_r_m_a_p_G_r_e_e_n_s Type: integer; Default: 0 Option: ----ggggrrrreeeeeeeennnnssss _n_u_m_b_e_r Description: Sets the preferred number of green colors in the Display PostScript colorcube. Values for the argument can be integers 0, 2-256. If the Page 14 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) value for this resource is zero, ShowPS uses resources in your .Xdefaults file to determine what value to use. For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r _G_u_i_d_e, Appendix D, in the section titled "Specifying zero as a color value." _c_o_l_o_r_m_a_p_B_l_u_e_s Type: integer; Default: 0 Option: ----bbbblllluuuueeeessss _n_u_m_b_e_r Description: Sets the preferred number of blue colors in the Display PostScript colorcube. Values for the argument can be integers 0, 2-256. If the value for this resource is zero, ShowPS uses resources in your .Xdefaults file to determine what value to use. For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r _G_u_i_d_e, Appendix D, in the section titled "Specifying zero as a color value." _c_o_l_o_r_m_a_p_G_r_a_y_s Type: integer; Default: 0 Option: ----ggggrrrraaaayyyyssss _n_u_m_b_e_r Description: Sets the preferred number of gray values in the Display PostScript colorcube. Values for the argument can be integers 0, 2-256. If the value for this resource is zero, ShowPS uses resources in your .Xdefaults file to determine what value to use. For a detailed explanation, see _S_h_o_w_P_S _U_s_e_r _G_u_i_d_e, Appendix D, in the section titled "Specifying zero as a color value." _d_i_s_p_l_a_y_S_h_o_r_t_c_u_t_P_a_n_e_l_D_i_a_l_o_g_A_t_S_t_a_r_t_u_p Type: boolean; Default: False Option: ----ddddiiiissss1111; Menu: Shortcut Panel Description: Instructs the previewer to open the Shortcut Panel at startup. The Shortcut Panel contains commonly used File, Page, and Controls menu commands. _d_i_s_p_l_a_y_S_c_a_l_e_S_e_l_e_c_t_i_o_n_D_i_a_l_o_g_A_t_S_t_a_r_t_u_p Type: boolean; Default: False Option: ----ddddiiiissss2222; Menu: Scale Selection Description: Instructs the previewer to open the Scale Selection panel at startup. The Scale Selection panel lets you enlarge or reduce the displayed image. _d_i_s_p_l_a_y_P_a_g_e_S_e_l_e_c_t_i_o_n_D_i_a_l_o_g_A_t_S_t_a_r_t_u_p Type: boolean; Default: False Option: ----ddddiiiissss3333; Menu: Page Selection Page 15 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) Description: Instructs the previewer to open the Page Selection panel at startup. The Page Selection panel lets you select a page for viewing. _d_i_s_p_l_a_y_P_a_g_e_O_r_i_e_n_t_a_t_i_o_n_D_i_a_l_o_g_A_t_S_t_a_r_t_u_p Type: boolean; Default: False Option: ----ddddiiiissss4444; Menu: Page Orientation Description: Instructs the previewer to open the Page Orientation panel at startup. The Page Orientation panel lets you change the orientation of the page within the window. _e_m_u_l_a_t_e_P_a_p_e_r_T_r_a_y_s Type: boolean; Default: True Option: ----eeeepppptttt; Menu: Emulate Paper Trays Description: Instructs the program to honor requests for paper tray changes that come from the PostScript language document itself by using a different size display when the document calls for a different size paper. When set to False, the program ignores paper tray requests. _i_g_n_o_r_e_C_o_m_m_e_n_t_s Type: boolean; Default: False Option: ----iiiiggggcccc; Menu: Ignore Comments Description: Instructs the program to ignore any DSC comments it finds in a document and to treat the document as unstructured. _m_a_x_P_i_x_m_a_p_B_y_t_e_s Type: integer; Default: 4 Mbytes Option: ----mmmmaaaaxxxxpppp Description: Allows you to set the maximum number of bytes allowed for the pixmap that the program draws to before displaying a page. See the ----mmmmaaaaxxxxpppp option for more information. In contrast to the ----mmmmaaaaxxxxpppp option, the value of this resource must be an integer. Scale factors (m and k) cannot be used. _m_o_n_o_c_h_r_o_m_e Type: boolean; Default: False Option: ----mmmmoooonnnnoooo; Menu: Monochrome Description: Instructs the program to display documents in monochrome even on a color display. This simulates the effect of printing on a monochrome printer. Page 16 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) _p_a_g_e_O_r_i_e_n_t_a_t_i_o_n Type: string; Default: portrait Option: ----oooorrrr; Menu: Page Orientation Description: Allows you to select the initial orientation of a previewed page. Possible settings are portrait, landscape, flip_portrait, flip_landscape. _p_a_g_e_S_i_z_e Type: string; Default: letter Option: ----ppppssss Description: Allows you to set the default page size. See PAGE SIZES for a list of standard page sizes. _p_r_e_S_c_a_n_S_i_z_e Type: integer; Default: 8200 Option: ----ppppssssccccaaaannnn Description: Certain applications prepend sequences of control characters and other text strings to the PostScript files they generate. When the previewer opens such a file, it searches through the first _p_r_e_S_c_a_n_S_i_z_e characters for the PostScript identifier string ``%!''. If found, the previewer starts rendering the PostScript file starting at the file offset where the identifier was found. If not found, the previewer assumes that the identifier starts at the character immediately following the first _p_r_e_S_c_a_n_S_i_z_e characters of the file. If the identifier string is missing, the previewer displays a dialog box that asks whether to display the file anyway. Unlike the ----ppppssssccccaaaannnn option, this resource must be an integer. Scale factors (m and k) cannot be used. If _p_r_e_S_c_a_n_S_i_z_e is greater than 100 Mbytes, an error message results. If _p_r_e_S_c_a_n_S_i_z_e is zero, the previewer skips the pre-scan and assumes that the PostScript identifier string starts in the first position in the first line of the file. The default value (8200) allows for the common case in which the header size is 8192 bytes. _p_r_o_l_o_g_F_i_l_e Type: string; Default: _n_o_n_e Option: ----ppppssss Description: Sets the pathname to an external PostScript prolog file. The previewer sends this file to the Display PostScript context after the internal Page 17 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) prolog and before the PostScript file. This resource can be used to implement stubs for site- specific ssssttttaaaattttuuuussssddddiiiicccctttt operators, which may be used in PostScript files at certain sites. _r_e_a_d_F_r_o_m_S_t_a_n_d_a_r_d_I_n_p_u_t Type: boolean; Default: False Description: Determines whether the program reads from _s_t_d_i_n by default, or only when the "-" option is used. If the "-" option is used to read from _s_t_d_i_n, or if the _r_e_a_d_F_r_o_m_S_t_a_n_d_a_r_d_I_n_p_u_t resource is True, the program may have to allocate a temporary file during processing of _s_t_d_i_n. By default, the file is placed in /_t_m_p and deleted automatically when it is no longer needed. Use the _t_e_m_p_D_i_r resource or the ----ttttddddiiiirrrr option to change the default directory. _r_e_p_o_s_i_t_i_o_n_E_P_S_F Type: boolean; Default: True Option: ----rrrreeeeppppssssffff; Menu: Reposition EPS Files Description: Determines whether the program places the upper left corner of an EPS image in the upper left corner of the page. _s_c_a_l_e Type: float; Default: 1.0 Option: ----sssscccc; Menu: Scale Selection Panel Description: Allows you to select the initial scale factor at which to view documents. _s_k_i_p_C_o_p_y_r_i_g_h_t Type: boolean; Default: False Option: ----sssskkkkiiiippppcccc Description: Instructs the program to bypass the display of the copyright notice upon startup. _s_u_b_s_t_i_t_u_t_e_F_o_n_t_s Type: boolean; Default: True Option: ----ssssffff; Menu: Substitute Fonts Description: Instructs the program to substitute Courier for any missing fonts. _t_e_m_p_D_i_r Type: string; Default: /tmp Page 18 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) Option: ----ttttddddiiiirrrr _d_i_r Description: When the previewer reads from _s_t_d_i_n, it temporarily stores the input in the directory specified by _t_e_m_p_D_i_r and later removes it. _v_e_r_b_o_s_e Type: boolean; Default: False Option: ----vvvv Description: When you set this resource to True, the program prints a short message to _s_t_d_e_r_r each time an error dialog box is displayed. _w_a_t_c_h_P_r_o_g_r_e_s_s Type: boolean; Default: False Option: ----wwwwpppp; Menu: Watch Progress Description: Instructs the program to update the display while rendering is in progress instead of waiting for a page to complete before displaying any of it. DDDDiiiissssppppllllaaaayyyy PPPPoooossssttttSSSSccccrrrriiiipppptttt NNNNXXXX XXXX RRRReeeessssoooouuuurrrrcccceeeessss The following X resources are used to coordinate the Adobe ShowPS application with the Display PostScript NX software. See the Display PostScript NX documentation for more information. _d_p_s_n_x_A_g_e_n_t Type: string; Default: _n_o_t _s_e_t Description: Selects Display PostScript NX agent to connect to. When this resource is not set, the Display PostScript NX agent default is used. String format: [_h_o_s_t_n_a_m_e]:[:]_p_o_r_t_n_u_m_b_e_r _d_p_s_n_x_A_g_e_n_t_E_x_e_c Type: string; Default: /_u_s_r/_b_i_n/_X_1_1/_d_p_s_n_x._a_g_e_n_t Description: Sets path to executable Display PostScript NX agent. _d_p_s_n_x_D_e_b_u_g_L_e_v_e_l Type: int; Default: 0 Description: Sets debug level for Display PostScript NX agent. _d_p_s_n_x_E_x_t_r_a_S_t_a_c_k Type: int; Default: 0 Page 19 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) Description: Adds extra stackspace for Display PostScript contexts. _d_p_s_n_x_L_i_n_g_e_r_T_i_m_e Type: string; Default: 0:05 Description: Sets the linger time, in [_h_h:_m_m] format, for the NX agent. Linger time is the time the agent listens for new connections before it disconnects. Default is five minutes. _d_p_s_n_x_N_o_L_o_g Type: boolean; Default: False Description: Sends Display PostScript NX debug log info to _s_t_d_e_r_r. _d_p_s_n_x_P_S_R_e_s_D_i_r Type: string; Default: _n_o_t _s_e_t Description: Sets path to Display PostScript NX agent resource directory. Typical value is /_u_s_r/_l_i_b/_X_1_1/_D_P_S. When this resource is not set, the Display PostScript NX agent default is used. _d_p_s_n_x_P_i_x_M_a_p_M_e_m_o_r_y Type: string; Default: _n_o_t _s_e_t Description: Sets use of pixmaps for Display PostScript NX agent. One of three arguments can be used: _l_i_m_i_t_e_d, _m_o_d_e_r_a_t_e, or _u_n_l_i_m_i_t_e_d. When this resource is not set, the Display PostScript NX agent default is used. _d_p_s_n_x_P_o_r_t_N_u_m_b_e_r Type: int; Default: _n_o_t _s_e_t Description: Sets port number for the Display PostScript NX agent. When this resource is not set, the Display PostScript NX agent default is used. _d_p_s_n_x_Q_u_a_n_t_u_m Type: int; Default: 1000 Description: Sets operator quantum for the Display PostScript NX agent. _d_p_s_n_x_S_y_n_c_h_r_o_n_o_u_s Type: boolean; Default: False Description: Sets synchronous mode in the Display PostScript NX agent. Page 20 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) _d_p_s_n_x_T_r_a_n_s_p_o_r_t Type: string; Default: _n_o_t _s_e_t Description: Sets Display PostScript NX agent transport protocol. Values are limited to one of the following: _t_c_p, _u_n_i_x, or When this resource is not set, the Display PostScript NX agent default is used. _d_p_s_n_x_U_s_e_X_F_o_n_t_s Type: boolean; Default: False Description: Causes the Display PostScript NX agent to use X11 fonts instead of Type 1 fonts for small sizes. BBBBUUUUGGGGSSSS If you are using a grayscale monitor and color pages are displaying poorly -- for example, if shades of red and blue are indistinguishable -- your X server is most likely misconfigured as a color server. This problem frequently manifests itself on SPARCstation X servers. Adding the option ----cccccccc 1111 to the command line that invokes your X server usually corrects the problem. If this does not work, or if you are unable to change your X server invocation, add the following lines to your ._X_d_e_f_a_u_l_t_s file: DPSColorCube.PseudoColor.8.reds: 0 DPSColorCube.PseudoColor.8.grays: 17 For more information, see ddddppppssss(1). SSSSEEEEEEEE AAAALLLLSSSSOOOO ttttrrrraaaannnnssssccccrrrriiiipppptttt(1), ffffiiiilllltttteeeerrrrppppssss(1), eeeennnnssssccccrrrriiiipppptttt(1) [1] O'Reilly & Assoc., _T_h_e _D_e_f_i_n_i_t_i_v_e _G_u_i_d_e_s _t_o _t_h_e _X _W_i_n_d_o_w _S_y_s_t_e_m, Vol. 0-7. [2] Adobe Systems Incorporated, _P_r_o_g_r_a_m_m_i_n_g _t_h_e _D_i_s_p_l_a_y _P_o_s_t_S_c_r_i_p_t _S_y_s_t_e_m _w_i_t_h _X (Addison-Wesley Publishing Co., 1993). [3] Adobe Systems Incorporated, _P_o_s_t_S_c_r_i_p_t _L_a_n_g_u_a_g_e _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l, Second Edition (Addison-Wesley Publishing Co., 1990). NNNNOOOOTTTTEEEESSSS Copyright 1991, 1992 Adobe Systems Incorporated. All Rights Reserved. Page 21 (printed 4/30/98) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) AAAAddddoooobbbbeeee SSSSyyyysssstttteeeemmmmssss ((((7777 DDDDeeeecccc 1111999999994444)))) SSSSHHHHOOOOWWWWPPPPSSSS((((1111)))) Adobe, Adobe ShowPS, PostScript, Display PostScript, and TranScript are trademarks of Adobe Systems Incorporated which may be registered in certain jurisdictions. Motif is a trademark of the Open Software Foundation, Inc. Page 22 (printed 4/30/98)